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PREFACE 


This manual describes the features and operation of version V009 
of the File Utility Package (PIP) for DOS/BATCH. The manual assumes 
familiarity with the DOS/BATCH Monitor, 

The file Utility Package is called PIP (Peripheral Interchange 
Program) for compatibility with similar programs on other DEC systems. 
Features provided by PIP include file transfers from one device to 
another , file deletions, file renaming, and directory listings. 

Appendix B, "Helpful Hints”, contain valuable information on 
possible solutions to problems that can arise while becoming familiar 
with PIP. 

This software is furnished to purchaser under a license for use 
on a single computer system and can be copied (with inclusion of DEC's 
copyright notice) only for use in such system, except as may otherwise 
be provided in writing by DEC. 

The information in this document is subject to change without 
notice and should not be construed as a commitment by Digital Equipment 
Corporation. Digital Equipment Corporation assumes no responsibility 
for any errors that may appear in this manual. 

Digital assumes no responsibility for the use or reliability of 
its software on equipment that is not supplied by DIGITAL. 
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CHAPTER 1 


INTRODUCTION 


The File Utility Package performs transfers of data files 
from standard PDP-11 I/O devices to other standard PDP-11 I/O devices 
and performs simple editing and control functions as well, PIP, 
Peripheral Interchange Program, handles all standard data formats 
used in the DOS/BATCH system. 

The major features provided by PIP are as follows: 

• Transfer a file or group of files from one device to another 
with output being either linked or contiguous (refer to 
section 3,1.5) ; 


• Merge a group of input files into a single (new) output file; 

• Allocate a contiguous file on disk or DECtape; 

• Rename an existing file; 

• Cause an input file having the same name as a file on the output 
device to replace that output file - also a switch to turn this 
mode on or off; 

• Delete a file or group of files; 

• Selectively perform an operation on each file of a group of 
files ; 

• Change the protection code on a file; 

• Print filename, file size, creation date, and protection code of 
each file in a disk, DECtape, cassette, or magtape directory. 

• Print a listing of the filenames on disk, DECtape, cassette, or 
magtape directory. 

• List the number of free blocks remaining on the device specified; 

• Zero (initialize) a disk (except RP03) , DECtape, cassette, or magtape 

• Perform fast copy and/or verify operations for DECtape. 

• Perform read-after-write verification for cassette tape. 

1.1 CALLING PIP 


The user must be logged into the Operating System before run- 
ning PIP. Any previous program in core must be removed with the 
KILL command. (The user should be familiar with the Operating System 
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commands before attempting to use PIP; particularly the RUN, LOGIN, 
KILL, and FINISH commands.) 


In response to the System Monitor* s dollar sign character, the 
user can type the RUN PIP command. For example: 

$RUN PIP 

PIP Vxx (xx is PIP version number) 

1 

Following the RUN command, PIP is called into core, prints its version 
number and a number sign. The number sign indicates that PIP is ready 
to accept a command string. Following completion of a command, PIP 
prints another number sign and awaits further commands. 


NOTE 


A convention followed throughout this manual 
is the underlining of all Monitor and system 
program printout to differentiate it from 
user-typed commands, which are not under- 
lined. Large sections of system program 
continuous output (such as directory listings) 
are not underlined. All commands are termi- 
nated with the nonprinting RETURN key, 
causing a carriage return/line feed operation. 


1.2 RECOVERING FROM ERRORS 


When using PIP, the user may receive an error message from time 
to time. 


An A error message issued by the Monitor indicates a need for 
operator intervention. In the event an A error occurs, the user should 
consult the DOS/BATCH-11 Programmer's Manual for a description of 
the error and then correct the error condition and give the CONTINUE 
command. For examples 


#DT1: ABC<PR: 
A002 063320 


^CONTINUE 

# 


(high-speed reader is out of tape, RAD50 
representations of standard devices are 
shown in Appendix A.) 

(put tape in reader and give CONTINUE command) 
(operation has been performed) 
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An S error message indicates some improper condition detected by 
PIP. Many S errors are correctable and recoverable. In the event an 
S error message occurs, the user should consult Chapter 7 of this 
manual for the meaning of the error and take corrective action accord- 
ingly. A typical problem is a bad command string, as is shown below. 


£ DT0 : EN 
S242 000000 

£DT0 : /EN 
# 


(the slash for the switch is absent) 

(meaningless command; no action taken) 

(retype the command correctly) 

(operation is performed and PIP is 
ready to accept another command) 


An F error message indicates a fatal condition has occurred. If 
an F error message occurs when using PIP, the user must perform a 
Monitor BEGIN or RESTART command before entering another PIP command. 
(See the description of error messages and of actions to take in the 
Appendix portion of the DOS/BATCH Monitor Programmer's Manual.) 

1.3 RETURNING TO THE DOS/BATCH MONITOR 
1.3.1 Interactive Environment 

To exit from PIP to the DOS Monitor, type CTRL/C (hold down the 
CTRL key while typing the C key) . This returns control to the DOS 
Monitor at which time the KILL command should be given prior to 
running another (system or user) program. Unless you wish to 
abort the current operation, you should not type CTRL/C and KILL 
until after PIP has responded with a #. 


1.3.2 Batch Stream 

When PIP is running from the batch mode, the batch command $KILL 
terminates PIP, stops all I/O, and closes all files. Processing 
continues at the next command prefixed by a dollar sign ($) . No 
arguments are specified for $KILL . 

The $KILL command can be entered from the console keyboard to 
abort the current job while in batch mode; for example, typing in the 
following sequence aborts the current job: 

tC (CTRL/C was typed; tC is echoed) 

.KILL 


1-3 



The following batch commands also force a KILL sequence: 


$CHANGE 

^FINISH 

$GET 

$JOB 

$RUN 


Refer to the Batch User's Guide for details. 
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CHAPTER 2 


COMMAND STRINGS 

All commands to PIP are processed by the Operating System's Com- 
mand String Interpreter (CSI) . This ensures a uniform command format 
among the various system programs operating under DOS/BATCH • This 
Chapter briefly describes the command string format of PIP. 


2.1 GENERAL COMMAND STRING FORMATS 

The most general format of a PIP command string is: 
output file<input file(s) 

A single input or output file is completely specified by the fol- 
lowing information : 

dev: filnam.ext [uic] 

where : 

dev: is the device on which the file 

currently resides or will reside 
following a transfer; 

filnam is the name of the file (if any) ; 

ext is the filename extension (if any) ; and 

[uic] is the user identification code (if specified). 

For example: 

DT0 : MACRO . OBJ [200,200] 
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Either an output or an input file specification can be followed 
by a switch specification in the command string, A switch specifica- 
tion indicates that some special PIP action is to be performed, (See 
Table 2-1 for a list of PIP switches.) The switch specifications are 
of two forms: 


or 


where : 


/sw:n 

/ signals a PIP switch specification 

sw indicates the two letter switch code 

:n indicates a decimal or octal value (sup- 

portive argument required by some switches) 


PIP commands can take a variety of formats, depending upon the 
action desired. Some PIP actions are caused when a switch is the 
only specification in the command string. Other PIP actions are 
caused by a file specification followed by one or more switch speci- 
fications in the command string. Examples of typical command strings 
are shown throughout the manual. 

2.2 DEVICE SPECIFICATION 


The device specification consists of two letters, followed, where 
necessary, by an octal digit indicating one of multiple units, and 
terminated by a colon. (The standard device specifications are shown 
in Appendix A.) An octal digit is required in the device specifica- 
tion to distinguish between units on multiple-unit devices. For ex- 
ample, DTI: and DT2 1 could be used to specify two DECtapes on the 
same controller. When no digit is indicated for a device, unit 0 is 
assumed by the system. 
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When no device is specified for a file, the desired device is 
assumed to be the last device specified on that side (input or output) 
of the angle bracket (<) . For example: 

£DK1 : <DT1 : FILE1 ,FILE2 

where FILE1 and FILE2 are on DECtape unit 1. 

When no device has been specified on the current side of the <, 
the system disk is assumed to be the default I/O device (except for 
/DI, /BR, and /FR switches where the teleprinter is the default out- 
put device and the System disk is the default input device) . For 
example, /DI will list the current user's system disk directory on 
the teleprinter. 

2.3 FILENAME SPECIFICATION 

A filename specification consists of from one to six letters or 
digits or an asterisk. All characters in excess of six are ignored. 
The asterisk feature is described in section 2.5. Examples of file- 
names are shown below: 

SEVENLE is interpreted as SEVENL 

A34B 

FILE 

* indicates all (filenames or extensions) 

Null fields in a command are ignored, e.g. 

£SY: <DK1: A, , ,B 

causes files A and B to be read from the DKl disk to the system disk 
as properly as if the superfluous commas were not present, i.e., 
filenames are separated by a comma. 

2.4 FILENAME EXTENSION SPECIFICATION 

The filename extension specification consists of a period 
followed by one to three letters or digits, or an asterisk. The 
asterisk feature is described in section 2.5. Extensions may be used 
to specify the format in which a certain file is stored, the version 
of a particular file, or any other information the user desires. 
Examples of filenames used with filename extensions are shown below: 
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FORT . 1A 
ABC. PAL 
FILE .TMP 
MODS. 001 
MODS. 002 

MAT.* all files with the name MAT 


Filename extensions, where associated with a filename, must be used 
to specify that particular file, unless the asterisk feature is used. 
A filename extension may not be used without a filename (except with 
an asterisk substituted for a filename, as described below). 


2.5 ASTERISK FEATURE 


The asterisk (*) character can be used in a command string to 
replace either the filename or filename extension specification. The 
asterisk can be read as "all files" with the filename or filename 
extension indicated. For example: 

* . TMP indicates all files with the extension .TMP 

FILE.* indicates all files with the name FILE 

The asterisk can appear in both positions: 

* a * 

which denotes all files on the specified device belonging to the user 
identification code specified (or the current user UIC if no UIC is 
specified) . 

Except where noted in this manual, the asterisk feature can be 
used in all transfer operations, all directory listing operations, 
deletion operations, protection operations and rename operations. 

PIP can reference all files with null extensions through use of 
the asterisk feature. For example, to delete all files with null 
(no) extensions, the command is: 

#*./DE 


2-4 



2.6 USER IDENTIFICATION CODE SPECIFICATION 


The User Identification Code (UIC) specification consists of a 
pair of 1- to 3-digit octal numbers, each of which may have a value 
between 11 and 376 (0—10 are reserved for special use) , separated by 
a comma, and enclosed within square brackets. (The left and right 
square brackets are typed using SHIFT/K and SHIFT/M on ASR-33's.) The 
left number specifies a user group and the right number specifies a 
particular user within a group. 

The User Identification Code is used in connection with file 
storage and file protection (see section 3.6) 1 . When a UIC does not 
appear in a command string, the UIC specified in the last LOGIN com- 
mand is assumed. The asterisk feature is allowed in the UIC for cer- 
tain switches (see sections 4.2.1 and 4.2.2.) Examples of acceptable 
UIC 1 s are shown below. 


Explicit non-current UIC specification and/or the asterisk 
feature are allowed in the UIC field for functions that do not 
disturb another user's area or for functions that are not explicitly 
prohibited by the other user. For example, if the user is logged 
in under account 200,200, the following actions are legal ; 

1. See section 4.2.1. 

2 . See section 4.2.2. 

3 . £SY : FILE . EXT<SY : OTHER . EXT[ 30,50] 

if OTHER. EXT is not protected from other user groups. 


The following actions are illegal ; 

1 . #SY : FILE . EXT[ 30 , 40 ] <SY : FILE2 . EXT 

2. £SY : [ * , * ]<SY : NAME .EXT 

3 . £SY : FILE . EXT<SY : PROT . EXT[ 30 , 60 ] 

if PROT. EXT is protected from other user groups. 


Examples of acceptable UIC's are shown below. 

[ 200 , 200 ] 

[ 200 , 201 ] three users in one group 
[200,244] 

[ 100 , 100 ] 

[376,376] 


Cassette tape does not have UIC specifications implemented. 
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Table 2-1 


PIP Switch Options 


Switch 

Code 

Switch 

Name 

Operation 

/AL 

Allocate 

Allocates a blank contiguous file 

/BR 

Brief 

Directory 

List only filenames and extensions in the 
directory of the device (s) specified. 

/CO 

Contiguous 

Create a contiguous output file. 

/DE 

Delete 

Delete the file(s) specified 

/DI 

Directory 

List the directory or a subset thereof 
for the device (s) specified. This includes: 
filenames , extensions , file size, creation 
date, and protection code for each file 

/EN 

Enter 

Enter the user identification code spec- 
ified into the Master File Directory 
of the specified device. 

/FA 

Formatted 

ASCII 

Transfer file(s) indicated in formatted 

ASCII mode 

/FB 

Formatted 

Binary 

Transfer file(s) indicated in formatted 
binary mode 

/FC 

Fast Copy 

Transfer all files from one DECtape to 
another 

/FR 

Free 

List the number of free blocks on the 
device (s) specified 

/IN 

Inspect 

List all files for confirmation before per- 
forming action so that user can proceed or 
bypass . 

/PR 

Protect 

Change the protection on the file(s) indicated 
to the value given 

/RE 

Rename 

Rename the file indicated to the name given 

/RU 

Rewind/ 

Unload 

Rewind the magtape or cassette tape unit 
specified and turn that unit off-line 

/RW 

Rewind 

Rewind the magtape unit specified 

/SU 

Supersede 

Cause the input file having the same name as a 
file on output device to replace that output 


file 
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Table 2-1 (cont'd) 


Switch 

Code 

Switch 

Name 

Operation 

/UA 

Unformatted 

ASCII 

Transfer file(s) indicated in unformatted 

ASCII mode 

/UB 

Unformatted 

Binary 

Transfer file(s) indicated in unformatted 
binary mode 

/UN 

Unlock 

Unlock the User File Directory to recover 
the file specified 

/V E 

Verify 

Verify that blocks on two DECtapes are alike, 
otherwise print differences 

/VW 

Verified 

Write 

Verify a write operation by reading the 
block after writing it 

/ZE 

Zero 

Initializes the file structure on the device (s) 


specified 


2.7 SWITCH SPECIFICATIONS 


The switch specification consists of a slash followed by two 
letters, and is optionally followed by a value specification of 
octal or decimal digits separated from the switch code by a colon. 
Switch names can be of any length; but, only the first two charac- 
ters are significant. 

Nontransfer operations in PIP are selected by use of switches. 

If more than one switch is used, each switch is preceded by a slash. 

A summary of the switch options is shown in Table 2-1. 

When present, a switch must follow any file or UIC specification; 
that is, a switch cannot appear before the filename, extension, or UIC 
of the file on which the switch is to operate. However, some switches 
may be specified without any file specification at all. 

Some options require a numeric value to be associated with the 
switch. Whether the value is octal or decimal depends upon the switch. 
For example: /PR is the switch to change the file protection code. 

The new protection code is preceded by a colon as follows: 

#DT1 : ABC/PR : 155 
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which changes the protection code of file ABC on DECtape unit 1 
to 155. Refer to section 3.6 for a description of protection codes 
and their uses. 

In general, PIP switch options can be grouped into two cate- 
gories: action switches and qualifying switches. Action switches 

are generally associated with some action or operation. Only one 
action switch can be used in any one PIP command. The action 
switches are as follows: 


/AL 

Allocate 

/BR 

Brief Directory 

/DE 

Delete 

/DI 

Directory 

/EN 

Enter 

/FC 

Fast Copy 

/FR 

Free 

/PR 

Protect 

/RE 

Rename 

/RU 

Rewind and Unload 

/UN 

Unlock 

/VE 

Verify 

/ZE 

Zero 


Qualifying switches are used to give PIP particular information 
about how to perform an operation. These switches can be used in 
conjunction with other switches in a single command string. The 
qualifying switches are: 


/CO Contiguous 

/FA Formatted ASCII 

/FB Formatted Binary 

/IN Inspect 

/RW Rewind 

/SU Supersede 

/UA Unformatted ASCII 

/UB Unformatted Binary 

/VE Verify 

/VW Verified Write 


Another type of distinction which is made among switches is 
that some can be used alone, some operate upon a single file 
designation, and some require both an input and an output specifi- 
cation, as follows: 
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Used 

Alone 

Used with One or More 
File Designations 

Used with Both an Input 
and Output Designation 

/BR 

/BR 

/BR 

/DI 

/DI 

/DI 


/ AL 

/FA 


/DE 


/EN 

/EN 


/FR 

/FR 



/PR 

/PR 


/RE 

/RE 


/UN 

/RW 



/CO 



/FR 



/FB 

/ZE 

/ZE 

/UA 


/SU 

/UB 


/IN 



/vw 
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CHAPTER 3 


FILE MANIPULATION 


3.1 FILE TRANSFERS 


The transferring of files between devices is a primary function 
of PIP. PIP uses the device independent features of the Operating 
System and can either copy a file directly onto another device or 
merge several files from the same or different devices into a single 
file on one device. 

3.1.1 File Copy Operation 

In the simplest case, PIP can transfer a file from one 
peripheral onto another. For example, to list a file, transfer a 
copy of the file to the line printer: 

£LP:<DT2:FILE1.PAL where FILE1 . PAL is on DECtape 

£LP : <MT1 : FILE2 . PAL where FILE2 . PAL is on magtape 

£LP : <FILE3* PAL where FILE 3 . PAL is on the system disk 

The following command transfers the data on a paper tape from the 
high-speed reader and creates a file named INPUT. TST on the system 
disk: 


£INPUT . TST<PR : 

The following command duplicates a paper tape: 

£PP: <PR : 

Ther$ can be only one output file designation in a PIP command, 
although there can be any number of input files (limited only by the 
teleprinter line length). For example, to copy three files (ONE. PAL, 
TWO. PAL, and THREE. PAL) from the system disk onto DECtape unit 0 , 
type: 


£DT : <ONE . PAL , TWO . PAL , THREE . PAL 
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In the case shown above, the files are copied directly to 
DECtape unit 0 , using the same filenames as on. disk. In order to 
later change the filenames, the RENAME (/RE) switch can be used: 

#DK : <DTl : FILEl , PR : ABC , MT : DEF . 001 
¥davei/re<filei 


The first command transfers three files onto the RK11 disk 
unit 0 ; FILEl from DECtape unit 1, ABC from the paper tape reader, 
and DEF . 001 from magtape unit 0 . Each file retains its original 
name. Note the ability to indicate the name of a file from the 
high-speed paper tape reader. The second command REnames the 
file FILEl on DK0: to DAVEl. 

3.1.2 Fast Copy and/or Verify Operations 

The FAST COPY (/FC) and VERIFY (/VE or /FC/VE) operations are 
applicable only to DECtape. Input and output device types must be the 
same; unit numbers must be different. The S260 or S231 error message 
will result if the preceding two conditions are not met. 

The format of these operations is illustrated in the three command 
strings shown below. 


£DT1:<DT2: /FC/VE 
or 

£DT1: <DT2:/FC 
or 

£DT1: <DT2:/VE 

PIP-11 allocates the largest amount of core memory available 
for the transfer buffer (buffers in the case of VERIFY operations) ; 
so that the larger the main memory, the faster the operation. On 
28K machines, for example, a DECtape can be copied in about 
two minutes; verifying it takes 2 1/4 minutes. 


3-2 



The VERIFY operation as shown above can be performed alone. If 
the data on the two devices differ , a message indicating the block 
and word in disagreement is printed at the console in the following 
octal format: 

Block Word 

N M 


3.1.3 File Merge Operation 

When there are several input files involved in a transfer, the 
files can be transferred individually, as the previous examples 
illustrate, or they can be merged into a single output file. 

When no output filename is specified on the output device, 
input files are copied without combining: 

#DT3 : <ABC , DT2 : RASP , PR : DEF 

Three files are copied onto DECtape unit 3; one from the system disk, 
one from DECtape unit 2, and one from the high-speed paper tape 
reader. Each retains the same name given on the input side. 

When a filename is specified on the output device, all input 
files are combined to create a single new output file. In order to 
combine the three files shown above into a single file named MERGE, 
the following command is used: 

£DT3 : MERGE< ABC , DT2 : RASP 3 PR : DEF 

Numerous variations on this operation are possible. One or more 
of the input files can be specified as being under another UIC, 
input files can be on the same or different devices, etc. 

An operation to merge a single file is equivalent to creating 
another copy of that file with a different name, e.g. 

£ABC<DT1:FILE1 


takes FILE1 on DECtape unit 1 and puts it on the system disk under 
the name ABC. 



3.1,4 File Transfer Modes 


The modes of transfer under the Operating System are either form- 
atted or unformatted, either ASCII or binary. Refer to the DOS/BATCH 
Monitor Programmer's Reference Manual for further details on the modes 
of transfer. 


In PIP , the mode of transfer of any file is determined by the ' 
format switch specified in the command string. If a format switch* is 
not specified in a command string, the mode assumed for the transfer 
is unformatted binary (unformatted ASCII if either device does not 
support binary) . This means, for example, that files transferred, from 
paper tape without a mode specification include blank frames, leader 
and trailer tape. Files transferred in this way may be larger than 
necessary. 
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A switch specified in the command string may be used to force a 
particular mode of transfer. The switches that specify format are /FA, 
/FB, /UA, and /UB. Only one type of format switch shall be specified 
in a command. The switch can be used with both input and output files. 
For example, to transfer the files ABC. DAT and ABC.TST in formatted 
binary mode: 

#DT4 : < ABC . DAT/FB , ABC . TST/FB 

or 

£DT4 : /FB< ABC . DAT , ABC . TST 

In the case of the paper tape reader, use of these switches guards 
against putting the tape in the reader backwards. For example, if 
the paper tape were in backwards, the command: 

#SPRMAN.OBJ<PR:/FB 

would cause PIP to print a S202 error message on the teleprinter. 

3.1.5 Contiguous Files 

Contiguous files are handled differently by the Operating Sys- 
tem than are regular, linked files. Blocks of contiguous files are 
guaranteed to be physically adjacent, whereas linked files are generally 
separated by a minimum fixed distance (called the interleave factor) 
to take advantage of the rotational delay inherent in a disk. Con- 
tiguous files are generally used for random accessing of data, a 
feature which is impossible with linked files. 

Unless otherwise specified, file transfers will produce linked 
files. The /CO switch is used to specify an output file as contiguous. 


Three cases exist where use of the /CO switch is valid. The 
first two cases apply to a merge operation and a copy operation. 

For each operation, a new filename is specified in the output field 
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of the command string. The /CO switch must be specified in the out- 
put side of the command string if the new file is to be created as a 
contiguous file, as shown below. 

1. A merge operation where the new file is to be made 
contiguous. For example, 

#SY : FILEME . RGE/C0<DK1 : FIL1 ,DT1 : FIL2 

2. A copy operation where the new file is to be made 
contiguous. For example, 

#SY:FILB/C0<DK1:FILA (see Note) 

NOTE 

In the case where the output file is explicitly 
named, the /CO switch must be on the output side. 

In both of the above cases, it makes no difference whether the input 
file(s) is contiguous or linked. The output file must be designated 
contiguous with the /CO switch. 

The third case applies to a simple transfer operation where no 
new filename is specified explicitly but the new output file(s) is 
to be made or is to remain contiguous. In this case, the /CO switch 
must be given on the input side of the command string for the file(s) 
desired to be contiguous on the output device. For example, 

#SY : <DK1 : FIL1/C0 ,FIL2 ,FIL3/C0 

Both FIL1 and FIL3 are created as contiguous files on the output 
device. FIL2 is created as a linked file, whether or not it is linked 
or contiguous. The same applies to the simplest case. For example, 

£SY : <DK1 : FILA/CO 

FILA is created as a contiguous file on the output device. If the /CO 
switch is not used, FILA would be created as a linked file on the out- 
put device, whether or not is is linked or contiguous on the input 
device. 

All other uses of the /CO switch are invalid. 

A contiguous file is denoted in a full directory listing by a C 
following the number of blocks for that file. 
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3-1*6 Transfers from the Teleprinter 


Occasionally, the user may wish to transfer a file from the 
teleprinter keyboard to another device. This is accomplished as fol- 
lows : 

#PP:<KB: 

Subsequent characters typed at the keyboard are output to the 
high-speed paper tape punch. (Punching is performed in bursts as 
the tape punch buffer fills.) To indicate an end-of-file with such 
an operation (i.e. to stop transferring data to the punch), the DOS 
convention is to type CTRL/C followed by the END command. 

In order to execute the command, the terminal must be in Monitor 
mode. Consequently, the sequence is: 

iC (type CTRL/C) 

^END (followed by the RETURN and 

LINE FEED keys respectively) 


The terminal LINE FEED keying is necessary to force control 
back to PIP after the END command is executed. PIP returns with a 
number sign (#) when the above sequence is completed. 

This same sequence is necessary when transferring from the 
low-speed paper tape reader. However, it is necessary to indicate 
the end-of-file from the user keyboard? the END PT command is given 
in this case. If the user types: 

#DF:FILEIN.MAC<PT: 

It is necessary to type: 

tC (type CTRL/C) 

^END PT (followed by the RETURN key 

and LINE FEED key respective- 
ly; no colon is used after PT) 

after the tape has been read and the low-speed reader stops. 

Note: Binary transfers are not allowed from the low-speed paper 

tape reader. 
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3.2 RENAMING FILES 


The RENAME switch is provided to allow the user a means of 
changing the name of a file. The general form of the command is: 

new filename<old filename 
with /RE on either side of the left angle bracket. 

If no device is specified, the system disk is assumed; for 
example : 


£MAIN . OBJ/RE <TESTX . OBJ 

changes the name of the system disk file TESTX.OBJ to MAIN. OBJ. 

When renaming, it is mandatory that the same device be used 
on both sides of the left angle bracket. The following is allowed: 

£DT:FILE1<FILE2/RE 

The device for FILE2 is assumed to be the DECtape. The same com- 
mand could be written as: 

£DT : FILEKDT : FILE2/RE 


If the /RE switch is omitted in the command string, the opera- 
tion performed is a copy operation which duplicates the input file 
on the same device, but under another name. In this case two copies 
of the file would exist on the same device. For example: 


#DT: FILEKDT :FILE2 



copies FILE2 into FILEl , both on DECtape unit 0. No error message 
is given since the command is for a valid transfer operation. 

Only one file at a time can be renamed. 

3.3 DELETING FILES 


The DELETE switch is provided to allow the user a means of 
deleting one or more files. The simple form of the command consists 
of a file designator followed by the /DE switch. For example: 

£DT : MAIN . LDA/DE 

which deletes the file MAIN . LDA from DECtape unit 0. 

Several files can be deleted by specifying a sequence of 
filenames before the DELETE switch. For example: 

fAB 5 DT : CD , DTI : EF . OBJ/DE 

deletes three files on three different devices. 

The DELETE switch supports the asterisk in the filename and/or 
extension fields of the file specifications. The asterisk is 
interpreted as "all", as in *.PAL meaning all files under the current 
UIC with an extension of .PAL. For example: 

£DT1:*. LDA/DE 

deletes all files with the extension .LDA from DECtape unit 1. 

£#.*/ DE 

deletes all files under the current UIC from the system disk. 

Files can be deleted from cassette tape without destroying 
adjacent files. For example: 

#CT1: FILE. MAC/DE 
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To delete all files from a DECtape, magtape , or cassette tape, 
it is recommended that the Zero switch be used, since that operation 
is much faster (see Sections 4.4,1 and 5.4). 

3.4 INSPECTING FILES 

The INSPECT switch (/IN) is an auxiliary switch which instructs 
PIP to type out the name of each eligible file, followed by a question 
mark, before executing the main operation. The user can then perform 
the operation on that particular file, by typing a Y (for yes) followed 
by the RETURN key? or he may bypass the file by simply typing the 
RETURN key. 

In general, /IN is used with file transfers and with the /SU, 

/DE and /RE switches and is particularly useful when used in conjunc- 
tion with asterisk-type commands. For example: 

#*.*/DE/IN 

which allows the user to edit (accept or reject) the contents of a 
whole directory. To continue: 

ABC. OBJ? Y ; Delete this file 

DEF.PAL? ; Do not delete this file 


etc . 

In the examples above, typing Y at the console caused the deletion 
of file ABC. OBJ. PIP listed another filename? the RETURN key was typed, 
file is left intact; PIP lists another file, etc. 

3 . 5 SUPERSEDE OPERATION 

When used on the input side of a transfer command, the SUPERSEDE 
switch (/SU) causes any input file having the same name as a file on 
the output device to replace that output file. Input files not 
existing on the output device will simply be transferred as usual. 

The /SU switch will not delete an output file if the input file to 
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replace it is not present on the input device. In this instance, an 
S error condition will be given and PIP will proceed to transfer any 
remaining files. 

The command is normally used in association with specific 
filenames specified only on the input side of the command string: 

#dev: <devl:A,B,C/SU 
or for asterisk-type transfers 
#dev:<devl:*.*/SU 

If the filename specification appears in the output side of the command 
string and the file already exists on the output device, the transfer 
is not made and an S257 error occurs, e.g., the command dev:A<devl : A/SU. 


In addition to its use as a stand-alone command, one can evoke 
a supersede mode with a /SU:ON command which will remain in effect 
until the mode is turned off with a /SU:OFF or until the program 
is killed through a return to the Monitor. The Monitor's BEGIN 
command does not affect the mode. Enabling the mode in this way 
obviates entering an /SU switch following each command. 

3.6 FILE PROTECTION CODES 


The PROTECT switch is provided to allow the user a means of changing 
the protection of a file. It is not applicable to cassette tape. 

The protection code is specified as an octal value argument to 
the switch and is treated as three fields corresponding to owner, 
user group, and all others. Each field is assigned an octal digit 
as described in Figure 3-1. 

The general form of this command is: 
dev: filnam. ext/PR: value 


such as: 


£FILE3/PR:355 

which changes the protection code of FILE 3 to 355. The protection 
switch works for DECtape and disk: 
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#DT0 : FILE4/PR: 155 


a £> well as: 


#DK1: ABC. DAT/PR: 300 


Owner User Group All Others 


Owner : Bit 6=1= Owner cannot write on or delete 

the file. This is a safeguard to prevent 
inadvertent deletion or over-writing. 

Bit 7=1= Protect the file from automatic 
deletion on FINISH 
(not implemented) 


User Group and all others: 


Function 


Code 

Delete 

Write 

Read 

Run 

0 

yes 

yes 

yes 

yes 

1 

no 

yes 

yes 

yes 

2 or 3 

no 

no 

yes 

yes 

4 or 5 

no 

no 

no 

yes 

6 or 7 

no 

no 

no 

no 


Yes indicates that the operation is allowed. For example , 
if a file belongs to user [23,10], a protection code of 3 
will allow user [12,4] to read or run but not delete or write 
on it. 

No indicates that the operation is not allowed. 


Figure 3-1 • File Protection Codes 





3.7 ALLOCATING A CONTIGUOUS FILE 

Whenever it is necessary to load a contiguous file from paper 
tape, a blank, contiguous file is first created. The ALLOCATE switch 
provides a means of creating a blank, contiguous file. This option 
requires a filename and a decimal integer value (being the number of 
64-word segments of storage to be allocated). For example: 

£DF : FILE/AL : 10 

allocates 640 contiguous words of file storage on the RF11 disk. A 
subsequent PIP command: 

£FILE<PR: 

causes the paper tape to be read into the contiguous file previously 
created. 

The ALLOCATE switch can be used to create a contiguous file on 
disk or DECtape. Note that the segments allocated are always 64 words 
and do not depend upon the block size of the device. For example, 

£DK0: FILE/AL: 100 

creates a blank contiguous file named FILE on device DK0. Since an 
RK11 device contains 256 words per block, the allocated file contains 
25 blocks, each 256 words in length. Each block contains four 64-word 
file segments. The number 25 followed by C is shown as the number 
blocks of the file on the full directory listing for the device on which 
the contiguous file was created. For example: 

£DK0: FILE/DI 

DIRECTORY DK0 : [200,200] 

24-AUG-72 

FILE 25C 24-AUG-72 <233> 
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Whenever it is necessary to create an empty, contiguous file, 
the characters :E are appended to the command string. For example: 

#_DF : FILEl/AL : 10 : E 

allocates 640 contiguous words of file storage on the RF11 disk as 
normally. However, pointers are set in the UFD file entry such 
that the space is apprently empty. A file allocated in this manner 
can accept partial sequential output (through a Monitor .OPENC call). 
The pointers are updated to reflect the end of the actual data 
entered in part of the allocated space. The same file can subse- 
quently be extended (through a Monitor .OPENE call) within the un- 
filled, allocated space. 
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CHAPTER 4 


DIRECTORY MANIPULATION 

A significant number of PIP features center around the manipu- 
lation of files within directories and of the directories themselves. 

4.1 ENTERING USER IDENTIFICATION INTO THE MASTER FILE DIRECTORY 

The User Identification Code (UIC) must appear in the Master 
File Directory (MFD) before a user is able to create his own files 
on the disk or DECtape. This code is generally entered into the MFD 
by using the ENTER switch in PIP, although the DOS system building 
program creates a few fundamental User File Directories (UFD's). Refer 
to the DOS/BATCH System Manager's Guide for further details. 

The UIC of the current user of the system is passed to the Opera- 
ting System by the LOGIN command. For example: 

$LOGIN 11,11 

sets the current UIC to [11,11]. In using the ENTER switch, the UIC 
of the current user is obtained from the system and written into a 
spare slot in the MFD. The recommended sequence is then: 

$LOGIN uic 
|run PIP 
PIP Vxxx 

#7En 

The LOGIN UIC code is now a valid UIC on the system disk. In order 
to enter a UIC onto the system disk other than the one used in the 
LOGIN command, the UIC can be specified as follows: 

# 1 200,213]/EN 

which enters the UIC [200, 213] onto the system disk. 

If no spare slots exist in the MFD 1 , PIP prints a fatal error 
message, and no attempt is made to extend the MFD. 


1 See Section C.2 for the number of UIC slots available on the UFD. 
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This procedure is not always necessary for DECtapes because the 
ZERO switch enters the UIC of the current user when the directory is 
initialized (see section 4.4.1). 

If a user other than the one originally zeroing the DECtape 
wishes to access files on the tape, he must enter his UIC on the 
DECtape or explicitly reference the UIC field of the original user 
during each reference. For example, if the DECtape on unit 1 had 
been originally zeroed and filled by UIC [50,50], user UIC [200,200] 
could reference those files by logging in under [200,200] and 
giving the following command: 

£DT1:/EN 

In general, then, an ENTER operation performs one of two 
services: for DECtapes it allows any user to access all files on 

the DECtape as though he had initialized the DECtape? and on the 
disk it creates a UFD for the current (logged in) UIC (or the UIC 
specified) , allowing that user to store files on the system disk 
with whatever protection is desired. 

4 . 2 DIRECTORY LISTINGS 

A listing of the directory of all or certain selective files on 
any file structured device can be printed on the teleprinter or line 
printer; (PIP assumes the teleprinter unless another device is specified 
in the command string) . The information listed in a directory is a 
subset of all the information in the UFD entry for each file. 

4.2.1 Full Directories 


A full directory (/DI) listing contains: two title lines to 
identify the device, UIC, and the data which are followed by all 
filenames and extensions; the number of blocks per file (followed 
by a C if the file is contiguous), file creation date, and file 
protection code (enclosed within angle brackets) ; plus the total 
number of blocks and file for that UIC. For example: 
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#/DI 


DIRECTORY DF0 : 


22-FEB-72 


MONLIB 

508c 

LINK11.0VR 

72C 

PIP . LDA 

77 

LINKOB.LDA 

107 

LINK11 . LDA 

63 

EDITH. LDA 

56 

PAL11R.0VR 

40C 

PALOB .LDA 

107 

0DT11R . OBJ 

53 

PAL11R.LDA 

65 

FORTRN 

90 

LIBR11 . LDA 

35 

FORTRN. OVR 

204C 

FORCOM.DGN 

68C 

FORRUN.DGN 

40C 

FORLIB . OBJ 

604 

EAELIB .OBJ 

604 

ADD4B .PAL 

66 

DEFIN .OBJ 

5 

DVB07 . PAL 

33 

PALS YM. PAL 

85 

F0RT0V.12K 

300C 

FORTRN. 12K 

118 

LINKOB . OBJ 

154 

LINK11 . OBJ 

94 

EDITH. OBJ 

85 

PALOB .OBJ 

138 

PALSYM . OBJ 

17 

PAL11R. OBJ 

77 


[50,50] 


00-XXX-70 < 37 7 > 

22-FEB-7 2 <2 33> 

22-FEB-72 <233> 

22-FEB-72 <2 3 3> 

22-FEB-72 <2 3 3> 

22-FEB-72 <233> 

22-FEB-72 <233> 

22-FEB-72 <233> 

22-FEB-72 <233> 

22-FEB-72 <2 33> 

22-FEB-72 <233> 

22-FEB-72 <2 33> 

22-FEB-72 < 2 3 3> 

22-FEB-72 < 2 3 3 > 

22-FEB-72 <233> 

22-FEB-72 <233> 

22-FEB-72 <233> 

22-FEB-72 <233> 

22-FEB-72 <233> 

22-FEB-72 <233> 

22-FEB-72 < 2 3 3> 

22-FEB-72 <233> 

22-FEB-72 <233> 

22-FEB-72 <2 33> 

22-FEB-72 <233> 

22-FEB-72 < 2 3 3> 

22-FEB-72 <233> 

22-FEB-72 <2 33> 

22-FEB-72 <233> 


TOTL BLKS : 3965 

TOTL FILES: 29 


Notice that the system device (DF0: in this case) was assumed and 
the user was logged in under UIC[50,50]. 

Whenever a file is transferred onto disk, cassette tape, or DECtape, 
the date in the directory reflects the date on which the transfer took 
place, not the date on which the file was created. 

The full directories of multiple devices can be obtained: 
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#DF ; 5 DTI : /DI 

DIRECTORY DF0 : [50,50] 


24-JUL-71 

MONLIB 

508 c 

LINK11.0VR 

36C 

PIP . LDA 

70 

0DT11R . OBJ 

51 

FORTRN.OVL 

152C 

FORTRN 

118 

LINKCB . LDA 

96 

LINK .LDA 

58 

EDIT . LDA 

56 

PALOB .LDA 

107 

PAL .LDA 

65 

PAL11R . CVR 

40C 

LIBR .LDA 

41 

FORCOM.DGN 

112C 

EAELIB . LDA 

555 

EAELIB . OBJ 

555 

TOTAL BLKS : 

2620 

TOTL FILES: 

16 

DIRECTORY DTI; 


24-JUL-71 

FORLIB . OBJ 

135 

EAELIB. OBJ 

136 

IOL01 .OBJ 

1 

DEFIN .OBJ 

1 

DVTB06 . PAL 

' 7 

FREE BLKS: 

282 

FREE FILES: 

51 


00-XXX-70 < 377 > 

17-JUL-71 <233> 

17-JUL-71 <233> 

17-JUL-71 <233> 

24-JUL-71 <2 3 3 > 

24-JUL-71 < 2 3 3 > 

17-JUL-71 <2 3 3> 

17-JUL-71 <233> 

17-JUL-71 <233> 

17-JUL-71 < 2 3 3 > 

17-JUL-71 <233> 

17-JUL-71 <233> 

17-JUL-71 <233> 

17-JUL-71 <00 > 

19-JUL-71 <233> 

19-JUL-71 <233> 


, 1 ] 


01-JUL-71 < 2 3 3 > 

01-JUL-71 < 2 3 3 > 

01-JUL-71 <233> 

01-JUL-71 <233> 

01-JUL-71 <233> 


When a full DECtape or cassette tape directory is obtained, the 
listing is concluded with the total number of free blocks and files , 
whereas with a disk the number of used blocks and files , are reported. 


The full directory listing can be limited to produce a partial 
list of specified files on one or more devices. The following 
example illustrates the use of the asterisk to list only those files 
with the extensions specified on the two devices specified: 
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#DF : * . OVR, * . OBJ , DTI : * . PAL/DI 


DF0 : 




LINK11.0VR 

36c 

17-JUL-71 

<233> 

PAL11R. OVR 

40C 

17-JUL-71 

<233> 

0DT11R. OBJ 

51 

17-JUL-71 

<233> 

EAELIB . OBJ 

555 

19-JUL-71 

< 2 3 3> 

DTI: 




DVTB06 . PAL 

7 

01-JUL-71 

<233> 


Notice that the UIC, date, and number of blocks and files for that 
UIC are not reported in partial /DI listings. 

Directory information about a particular file can be obtained 
by specifying the filename and extension with the /DI switch. For 
example : 

0FTN000 . OVL/DI 


DK0 : 

FTN000 . OVL 10C 15-JUL-71 <233 > 

This obtains all information about FTN000.OVL if it is in the DK0 : 
directory. (If the file is not in the directory , there is no 
listing, and no error message.) 

Any UIC directory on any device can be listed by specifying 
that UIC in the command to PIP. For example, if a user is logged 
in under UIC 200,200, he can give the following command (the results 
are shown below) : 

£DK1:[50,50]/DI 
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DIRECTORY. DK1 : 


[50,50] 


21- JUL-71 


FORCOM.DGN 

27C 

01-JUL-71 

<233> 

FORT RN. 08K 

2 3 

01-JUL-71 

<233> 

IVK08K.LDA 

21 

01-JUL-71 

<233> 

0VL18K. LDA 

26 

01-JUL-71 

<233> 

OVL28K.LDA 

23 

01-JUL-71 

<2 33> 

OVL38K.LDA 

26 

01-JUL-71 

< 2 3 3 > 

OVL48K.LDA 

28 

01-JUL-71 

<2 33> 

OVL58K.LDA 

28 

01-JUL-71 

<233> 

OVL 68 K . LDA 

25 

01-JUL-71 

<233> 

FORTRN. 12K 

23 

01-JUL-71 

<233> 

OVL0 . LDA 

21 

01-JUL-71 

<2 3 3 > 

0VL1 . LDA 

26 

01-JUL-71 

< 2 3 3> 

0VL2 . LDA 

23 

01-JUL-71 

< 2 3 3> 

0VL3 -LDA 

26 

01-JUL-71 

<233> 

0VL4 .LDA 

28 

01-JUL-71 

<2 33> 

0VL5 -LDA 

28 

01-JUL-71 

<233> 

0VL6 .LDA 

25 

01-JUL-71 

< 2 3 3 > 

TOTL BLKS : 

123 



TOTL FILES: 

39 




If the user requests information on any particular file or uses the 
asterisk feature where no such file exists, no error message is 
given. The directory is considered blank; and a blank line is 
printed. In the example below there is no *.OVR file on DT0 2 


#D F : * . OVR, DT0 : * . OVR/DI 


D.F0 : 

LINK11 . GVR 36 C 21-JUL-71 < 233 > 

PAL11R.0VR 40C 21-JUL-71 <233> 

DT0 : 


4.2.2 Brief Directory Listings 


The BRIEF DIRECTORY (/BR) switch can be used to list only the 
deivice name, filenames, and extensions. The asterisk and specific 
filenames can be used with the BRIEF DIRECTORY switch to obtain 
partial brief directories. 
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The following PIP example demonstrates the correspondence 
between /DI and /BR directory listings. 

#* . OVL/DI 


DK0 : 


FTN000 . OVL 

100 

15-JUL-71 

<2 3 3> 

FTN001 . OVL 

9C 

15-JUL-71 

<2 3 3> 

FTN002 . OVL 

7C 

15-JUL-71 

<233> 

FTN003 . OVL 

9C 

15-JUL-71 

<233> 

FTN004 . OVL 

10C 

15-JUL-71 

<233> 

FTN005 . OVL 

11C 

15-JUL-71 

<233> 

FTN006 . OVL 

8C 

15-JUL-71 

<233> 


#* . OVL/BR 


DK0 : 

FTN000 . OVL 
FTN001 . OVL 
FTN002 . OVL 
FTN003 • OVL 
FTN004 . OVL 
FTN005 . OVL 
FTN006 . OVL 


An example of the /BR switch with the system device assumed 
is shown below: 


£/BR 


DF0 : 

MONLIB 

LINK11.0VR 

PIP . LDA 

FCL .PAL 

PAL11R.0VR 

PAL 

LINK 


Other examples of /BR switch usage are shown below: 


£FOR. E/BR 


DF0 : 

FOR .E 
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The asterisk (*) feature for filenames and extensions works 
for directory listings, both full and brief form. For example, the 
command : 


# * . PAL/BR 

gives a brief directory listing for all files on the user’s disk 
area with an extension of .PAL. The asterisk can appear in the 
filename field, the extension field, or both. In addition, groups 
of file specifiers can be arranged to provide sequential listings, 
as in : 

£DT0 : * . MAC , DF : FORTRN . */DI 


The asterisk feature can be used in the UIC field when obtaining 
directory listings . 

£LP:<DK:[*,*]/DI 

All directories on RK11 unit 0 are listed on the line printer. 

£LP : <DF : [ * ,2001/DI 

A listing is produced of all directories associated with user number 
200 , in every project. 

£LP: <DK:*.MAC[*,*]/DI 

A directory of all files with extension .MAC, on RK11 unit 0 , 
is produced. 
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4 . 3 FREE BLOCKS 


Since a full directory listing of a system disk provides the 
user only with a summary of the number of blocks used by his 
current UIC, the /FR switch is available for determining the number 
of free blocks remaining. For example: 

#/FR 


DF0 : 

FREE BLKS : 5513 

This switch can be used with any file-structured device , but is 
generally only necessary with disk, as the information is provided 
automatically with a DECtape. Further examples of the /FR switch 
follow: 

#/FR 


DK0 : 

FREE BLKS: *1113 
#DF: ,DT0:/FR 


DF0 : 

FREE BLKS: 3243 
DT0 : 

FREE BLKS: 282 

4.4 DECTAPE AND RK11 DISK INITIALIZATION 

(See Chapter 5 for magtape initialization and Chapter 6 for 
cassette initialization. ) 

4.4.1 DECtape 

In order to initialize a new DECtape with the basic file 
structure information required by the DOS/BATCH Monitor, the ZERO 
switch is provided. 
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The ZERO switch causes PIP to create on the DECtape specified 
the permanent bit maps, the file bit maps, the MFD, and a UFD for 
the UIC currently running on the System. 

The ZERO switch can be used either by itself, as in: 

£DT0:/ZE 

or in combination with other actions, as in: 

£ DT0 : ONE/' ZE < DT 1 : A , B , C 

The latter command zeroes DT0 : first, then creates file ONE on DT0: 
by merging files A, B, and C from DECtape unit 1. When used 
in combination with other actions, ZERO is performed before any 
other implied actions. 

The /ZE switch can be used to zero only one DECtape per PIP 
command string. In order to zero two DECtapes, proceed as follows: 

£DT:/ZE 

£DT1:/ZE 

4.4.2 RK11 Disk 

Before initializing an RKll cartridge with the ZERO switch, en- 
sure that the cartridge has been formatted using either the RKll 
diagnostic program (MAINDEC-11-D5HA-PB2 ) or the SYSLOD System Program. 
Consult the system administrator for local procedures. The following 
actions occur during cartridge initialization. 


1. The entire disk cartridge is zeroed? 

2. The first and second MFD blocks are written? 

3. The UIC of the current user (and only this UIC) 
is entered in the MFD? then 

4. Bit map blocks are written 

A RKll disk is initialized by typing: 

£DKn:/ZE 

where n is the octal number of the appropriate cartridge (or omitted 
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if DK0 is meant) . PIP responds by printing: 


CONFIRM: 


to which type either H (for high-density) or L (for low-density) 
followed by the RETURN key. Should the user decide not to initialize 
the disk, he types the SPACE bar before typing the RETURN key. 

High-density cartridges are marked 2200 BPI, and low-density 
cartridges are marked 1100 BPI. 

When the disk has been initialized (there is a noticeable pause) 
PIP again prints the number sign (#) to indicate readiness to accept 
another command. 

4 . 5 RECOVERING FILES 


There are a number of infrequent ways in which a file can be 
left in a state which makes it inaccessible for subsequent processing. 
For example, if a file is open and a system crash (hardware or soft- 
ware) occurs causing the Monitor to be reloaded, the file will likely 
be left in an inaccessible state. 

Files which are declared inaccessible by the Monitor will likely 
have up to three things wrong with them: 

1. The LOCK bit in the UFD entry for this file will be set. 

2. The USAGE COUNT in the UFD entry for this file will be 
invalid. 

3. Some blocks allocated for this file may not have the 
proper bits set in the permanent bit map. 

PIP provides a partial solution to this problem with the UNLOCK 
switch. The function of this switch is to restore the LOCK and 
USAGE COUNT fields so that the file can be read. It does not make 
an attempt to set bits in the bit map for the blocks. 

The sequence for recovery is to use the UNLOCK switch, such as: 

^RUN PIP 
PIP Vxxx 
#DF: FILE. OLD/UN 


which allows the file to be accessed. 
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Then, BEFORE WRITING ANY NEW DATA ON THE DISK , copy the file (if 
you want it) to another device and DELETE IT from the disk. 


#DT: <FILE 
0FILE/DE 

Copy, then delete ALL FILES WHICH WERE OPEN WHEN THE CRASH OCCURRED . 
You may then use the disk safely. 
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CHAPTER 5 


MAGTAPE OPERATION 


5.1 GENERAL MAGTAPE INFORMATION 


Magnetic tape is supported by PIP for following operations: 


a. Directory listings; 

£MT1:/DI 
£MT0 : /BR 


b. File transfer operations; (a magtape reel must be 
initialized before any files are transferred to 
the reel for the first time. See Section 5.4 for 
the initialization procedure) . 

£MT1 ; FILE<DT2 : ABC 

£MT : MERGEL<ABC , DT0 : FACT , MT1 : DATA 

c. ' Magtape initialization (see Section 5.4); 

£MT1:/ZE 

d. Rewind, Rewind Suppression, and Rewind and Unload (see Section 
5 . 2 and 5.3). 


Transfer and directory operations include all asterisk features 
used for other file-structured devices. For example, it is 
possible to type: 

£MT1: [*,*]/DI 
or 

£MT1: [#,#]/BR 

This allows the user to obtain a complete listing of all files on 
the specified magtape(s). When this option is used, the UIC speci- 
fication is printed as part of the file information. For example: 

£MT0:[«,»],MT1:[*,»]/DI 
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5 . 2 REWIND 


The REWIND switch is applicable to magtape units (MTn) and 
cassette drives (CTn) only, and controls rewind operations for one or 
more specified units. The specified unit(s) can still be addressed 
after use of the REWIND switch. The specifications /RW and /RW:YES 
cause the specified unit(s) to be rewound; the specification /RW:NO 
prevents rewinding of the specified unit(s). 


EXAMPLES: £MT1:/RW 

causes magtape unit 1 to be rewound on its 
original reel. 


|DK0.: <MT2 : * . */RW: NO 

causes all files under the current UIC on 
magtape unit 2 to be transferred to disk 0 
without rewinding magtape unit 2 between 
file transfers. 


#DK0 : <MT1 : FILE . ONE/RW: YES 

causes magtape unit 1 to be rewound before 
and after transferring FILE. ONE to disk 0 . 


#MT0 : /RW : N0<MT1 : * . */RW:NO, MT2 : * . MAC/RW : NO 

causes the following to take place, in order: 
(1) starting at the current position of mag- 
tape unit 1, all files under the current UIC 
on magtape unit 1 are transferred to magtape 
unit 0 without rewinding between file trans- 
fers; then (2) starting at the current posi- 
tion of magtape unit 2, all files under the 
current UIC with extension .MAC on magtape 
unit 2 are transferred to magtape unit 0 with- 
out rewinding between file transfers. 


If the REWIND switch is not specified for an operation, a de- 
fault value of /RW : YES is assumed. 
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5.3 REWIND/UNLOAD 


The REWIND/UNLOAD switch is applicable only to tape units. 
This switch causes the tape to be wound back on its original reel 
and the tape unit to be switched off-line. Following this option 
the tape unit(s) cannot be addressed for further processing. For 
example : 


#MT:/RU 


or 


#MT2: ,MT3 • /RU 

5.4 ZERO (INITIALIZATION) 


It is mandatory that a magtape be zeroed before use. The /ZE 
switch writes two end-of-file marks on the tape so that it can be 
handled correctly by the System Monitor. For example: 


#MT2 :/ZE 

5.5 MAGNETIC TAPE FORMAT 


All files on magnetic tape have the general format, exclusive 
of data format, as shown in Figure 5-1. 

Any file on the tape may be retrieved by name. 
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LOAD POINT 


OR EOF 


RECORD 1 

FILE 

LABEL 

RECORD 2 

DATA 

RECORD 3 

DATA 


• 

RECORD n-1 

DATA 

RECORD n 

EOF 


Figure 5-1 Magtape General 


7 words 

256 words 

256 words 

256 words 


Format 
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CHAPTER 6 


CASSETTE TAPE OPERATION 

6.1 GENERAL CASSETTE TAPE INFORMATION 


Cassette tape is suppored by PIP for the following operations: 

a. Directory Listings; 

#CT0:/BR 

#CT :/DI 

b. File Transfer Operations (a cassette cartridge must be 
initialized before any files are transferred to the 
cartridge for the first time. Refer to section 6.3 for 
the initialization procedure) ; 

#_CT : SOURCE . MAC<DK : MACRO . MAC 

#CT : MERGE . MAC<CT1 : FI LEI . MAC , DK1 : FILE2 . MAC 

c. Cassette Tape Initialization (Refer to section 6.3); 

#CT : / ZE 

d. Rewind Specifications (Refer to section 6.2); 

#CT:/RW 

#CT:/RW:N0<CT1: *. */RW:NO 

e. Read-after-Write Verification (Refer to section 6.5). 

#CT : /VW<CT1 : FILE . MAC 

The transfer and directory operations include all asterisk 
features used for other file-structured devices. This allows the user 
to obtain a complete listing of all files on the specified cassette. 


6.2 REWIND 

The REWIND switch is applicable only to cassette (CTn) and mag- 
tape (MTn) drives. This switch causes the tape to be rewound back 
onto its original reel. Following this operation, the cassette unit(s) 
still can be addressed. The following are examples. 

#CT1 : /RW J 

|CT0: ,MT1 : /wO 

The REWIND switch can be used to explicitly enable rewinds during 
the specified cassette operation. The following example rewinds CTl 
before seeking the file specified for the transfer operation. 

f_DK0: <CT1 : FILNAM.EXT/RW : YES^ 
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The REWIND switch also can be used to suppress rewinds during the 
specified cassette operation. For example, 

JDK0 : < CT 1 : * . */ RW : NO J 

transfers all files onto the disk without rewinding CT1. 


6.3 ZERO (INITIALIZATION) 

It is mandatory that a cassette be zeroed before use. The /ZE 
switch writes a sentinel label record (i.e., logical EOT) on the tape 
so that it can be handled correctly by the System Monitor. The following 
example, 

#CT1:/ZE 

zeroes (initializes) CTl . 


6.4 CASSETTE TAPE FO R MAT 

All files on cassette tape have the general format, exclusive of 
data format, shown in Figure 6-1. Any file on the tape can be retrieved 
by name. 



16 words 

64 words 
64 words 


64 words 


Figure 6-1 


Cassette General Format 


6 . 5 READ-AFTER-WRITE VERIFICATION 

Throughout the transfer, after writing each record, the cassette is 
backspaced and the record is read and verified against tne contents of 
the user's buffer. Notification of verification failures are printed on 
the operator's console as either 1100 or F076 error diagnostics., 


6-2 




CHAPTER 7 


ERROR MESSAGES 


As a system program under the DOS/BATCH Operating system, error 
messages received when using PIP conform to the standards for error 
handling. PIP's error messages are of the form: 

Sxxx n 


where Sxxx indicates a system program error number and n is one octal 
word displaying additional information. 

Error messages that PIP may issue are listed in Table 7-1. Consult 
the DOS/BATCH Monitor Programmer's Reference Manual or the DOS/BATCH 
Batch User's Guide for a description of all Monitor error messages. 
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Table 7-1 


PIP System Program Error Messages 


ERROR 

CODE 

ADDITIONAL 

INFORMATION 

MEANING 

S202 

Error 

Status Byte 

End of Data (EOD) or device error on 
.WRITE or .READ. 

S203 

0 

Illegal switch, or too many switches, or 
illegal switch value, switch value not 
given or illegal switch in output field 

S204 

0 

Too many or too few output files 

S205 

0 

Too many or too few input files 

S207 

Error 

Status Byte 

EOD or device error on .TRAN 

S231 


Illegal command, file-structured device 
required 

S232 


More than one action switch (only one permitted) 

S233 


Specified UIC not found in MFD 

S234 


Null filename or * given where filename 
required 

S235 


No files found in UFD 

S236 


Operation applicable to DECtape only 

S237 


File not found during file recovery 
operation 

S240 


No space for file allocate 

S241 


MFD is full 

S24 2 


Meaningless command (no action taken) 

S252 

9 

Filename given when none allowed 

S257 

File Block 
Error Code 
dev:file,ext. 

Illegal file operation. For example, 
protect code does not allow transfer of 
file; UIC different from login UIC thus 
making certain "wild card" operations 
illegal. The operation in question is not 
performed. 

S260 

9 

Same device needed for input and output in 
fast copy operation. 
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Table 7-1 (cont'd) 


ERROR 

CODE 

5262 

5263 

5264 

5265 

1100 

1354 

F076 


ADDITIONAL 

INFORMATION MEANING 

0 Record size too big for buffer. 

File File record sizes do not agree on 

Number verify /VE) . 

0 Conflict in standard filename extension 

which determines mode of transfer. Use 
explicit switches to resolve. 

0 Operation attempted on device which is not 

legal for non-privileged user. 


Hardware Status Single verification failure on cassette tape. 
Register Content 


Illegal response to CONFIRM? when attempting 
to zero an RK11 disk cartridge. Legal re- 
sponses are: 

H - for high density disks (RK03/05) 

L - for low density disk (RK02) 
blank - to cancel the request 


Device Cassette tape encountered enough read-after- 

(RADSjJ) write failures to exhaust the retry count. 
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APPENDIX A 


SUMMARIES 


Switch 

Name 

Example 

Operation 

/AL 

Allocate 

#DF:FILE/AL:10 

640 (10 x 64) contiguous 
words of file storage is 
allocated on disk. 

/BR 

Brief 

Directory 

£DT0:/BR 

List all filenames and exten- 
sions in directory for DEC- 
tape 0 on the user’s teleprinter. 

/CO 

Contiguous 

#DT0 : < ABC/CO 

Transfer file ABC as contigu- 
ous file from system disk to 
DECtape 0. 



#DT0:AD/CO<ABC ,DEF 

Merge files ABC and DEF (on 
system disk) as one contigu- 
ous file on DECtape 0 . 

/DE 

Delete 

#MAIN/DE 

#DT0 : ABC ,DT1 :DEF/DE 

Delete file MAIN from system 
disk. 

Delete files ABC and DEF from 
DECtapes 0 and 1 respectively. 

/DI 

Directory 

#DTJ? :/DI 

List all filenames, extensions, 
size, creation date, and pro- 
tection codes in directory for 
DECtape 0 onto the user 1 s 
teleprinter 

/EN 

Enter 

£DF s /EN 

Enter current user’s UIC in 

MFD on the specified disk (device) 

/FA 

Formatted 

ASCII 

#LP : /FA<DT0 : ABC 

Copy file ABC from DECtape 0 
to line printer in formatted 

ASCII mode. 

/FB 

Formatted 

Binary 

#DT0 : < ABC/FB 

Copy file ABC from system disk to 
DECtape 0 in formatted binary 
mode . 

/FC 

Fast Copy 

#DTls<DT2:/FC 

Data on DECtape #2 is fast 
copied onto DECtape #1. 

/FC/VE Fast Copy 
and Verify 

#DT1:<DT2: /FC/VE 

Data on DECtape #2 is fast 
copied and verified onto 

DECtape #1. 

/FR 

Free 

#DT1 : /FR 

List the number of free 
blocks remaining on DECtape 


unit 1. 
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Switch Name 


Example Operation 

/IN Inspect #_*.*/DE/IN Used in conjunction with file 

transfers and /SU, /DE, and 
/RE switches. Allows user to 
selectively perform the primary 
function. (User gives Y to per- 
form action on the displayed filt 
or types the RETURN key to leave 
file intact.) 


/PR 

Protect 

# ABC/PR: 355 

/RE 

Rename 

#_ABC/RE<DEF 

#DT0 : GHI/RE<DT0 : JKL 

/RU 

Rewind and 
Unload 

#MT1 :/RU 

/RW 

Rewind 

£MT1 : /RW 

/£5U 

Supersede 

#dev:<devl:A,B,C/SU 

/UA 

Unformatted 

ASCII 

#LP : /UA<DT0 : ABC 

/UB 

Unformatted 

Binary 

#DT0 : <ABC/UB 

/UN 

Unlock 

#DF: FILE. OLD /UN 

/VE 

Verify 

#DT1 ; <DT2 : /VE 

/VW 

Verified 

Write 

#CT:VW<CT1: FILE. MAC 

/ZE 

Zero 

#DT0:/ZE 


Change protection code of system 
disk file ABC to 355. 

Rename file DEF to ABC. 

Rename DEC tape 0 file JKL to 
GHI. 

Causes the tape on magtape 
unit #1 to be wound back on 
its reel and the unit to be 
switched off-line. 

Causes the tape on magtape 
unit #1 to be wound back on 
its reel. The unit can still 
be addressed. 

Causes files on the input side 
(DEVI) to replace files of the 
same name which may already be 
on the output device (dev) . 

Copies file ABC from DECtape 0 
to line printer in unformatted 
ASCII mode. 

Copies file ABC from system disk 
to DECtape 0 in unformatted bi- 
nary mode. 

Unlocks FILE. OLD after a system 
failure so that FILE. OLD can be 
accessed. 

Data on DECtape #1 and DECtape 
#2 are compared block-by-block; 
disagreements are shown by 
printing block and word numbers 
at the console. 

Verify a write operation 
by reading it after writing 
it. 

Erases all files from directory 
of DECtape 0 by initializing the 
file structure. 
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Standard 

Device 

Specification 

Device 

Radix-50 

Equiv. Code 

CR: 

Card Reader 

012620 

CTn: 

Cassette Tape, n=0,l 

01270 

dc: 

Fixed Head, Disk, RC11 

014570 

DF: 

Fixed Head Disk, RF11 

014760 

DKn : 

Cartridge, RKll, n=0-7 

015270 

DPn : 

Cartridge, RP11, n=J2f,7 

015600 

DTn : 

DECtape, unit 0-7 

016040 

KB: 

Keyboard ( teleprinter ) 

042420 

LP: 

Line Printer 

046600 

MTn : 

Magnetic tapes, unit = 0-7 

052140 

PP: 

High-speed paper tape punch 

063200 

PR: 

High-speed paper tape reader 

063320 

PT: 

Low-speed (teleprinter) paper 
tape reader/punch 

063440 

SY: 

System Device 

n/a (see note below 


NOTE 


The device specification, SY, is used to 
designate the device on which the 
Resident Monitor and system software are 
resident. 
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APPENDIX B 


HELPFUL HINTS 


There are a few things which are obvious to experienced DOS/BATCH 
users, but the beginner often has to learn them empirically. This 
section is meant to help the beginner avoid some common pitfalls. 

1. If you are having difficulty running PIP, make sure that: 

a. You are logged in, 

b. You did a KILL command after running the last 
program prior to running PIP. 

c. The PIP load module is on the disk, or, 

d. You are accessing the proper UIC field on the DECtape , 
if attempting to run from DECtape, i.e., you should 
be logged in under the same UIC as shown on the 
directory of the DECtape. 

2. If you are having difficulty accessing a DECtape file 
which you are positive is there, you are probably logged 
in under a different UIC than appears on the DECtape. In 
this case, either: 

a. Explicitly specify the UIC in the command 

b. FINISH and LOGIN under the proper UIC, or, 

c. ENTER your UIC on the DECtape (see Section 4.1). 

3. If you are having difficulty transferring to the line 
printer, make sure the printer is on-line; set the switch 
to ON LINE. 

4. If you are having difficulty reading a file and there 
has recently been a software or hardware crash, read 
Section 4.5, Recovering Files. 

5. If you continue to get file structure errors on output 
files, you are probably trying to create a file which 
already exists. The System does not allow this, so delete the 
file first or use the SUPERSEDE (/SU) switch. 
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6 . 


If you are logged in for the very first time and cannot 
create any files, it is because you have no User File 
Directory (UFD) in the Master File Directory (MFD) . To 
create one, log in, call PIP and type: 

#SY:/EN 

and you are all set. 

7. If you cannot write anything on a DECtape even though 
the WRITE switch is on, it is likely that: 

a. The DECtape belongs to someone else and he does not 
want you to write on it accidentally, or 

b. The tape has not been certified. 

If the DECtape does belong to someone else, you may still 
write on it by using the ENTER switch to put your 
UIC in the directory of the DECtape, as in: 

# DT0 : /EN 

Uncertified DECtapes can be certified using a diagnostic 
program (TC11 DECtape Formatter MAINDEC-ll-YPTB-PB) 
supplied with the maintenance programs. 

8. Use of the /RW:NO option when transferring files from 
magtape and cassette can save much time normally lost during 
a rewind operation. 

9. If experiencing trouble with transfers from the card 
reader, check to ensure that (1) control cards are 
compatible with the card reader type, and (2) end-of- 
file cards are compatible with the current version of 
the Monitor. 
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APPENDIX C 


PROGRAMMING CAUTIONS 


C.l ASTERISK FEATURE 


Use of the asterisk feature with the /CO switch in a merge 
operation only obtains the first of the asterisk-specified input 
files. No error message is given. 

If the user attempts to transfer a series of files (with the *) 
in which one has a protection code that does not allow transfer, a 
fatal Monitor error will result when PIP attempts to transfer that 
file, and successive files designated for transfer in that command 
string will not be transferred. 

If a file appears on disk or DECtape with a name not acceptable 
to the CSI , it must be deleted using the * feature. For example: 

ABC. A (2 spaces in extension) 

is not acceptable and should be deleted: 

ABC.*/DE 

The above works unless the file is locked? in which case it must 
be unlocked. See Section 4.5. 

To copy files from one device to another using the *, the 
* must be in the input field of the command string. For example: 

devl : <dev2 : * . * 
or 

devl : <dev2 : * . PAL 

When transferring files, the * cannot be specified in the 
output field of the command string? it will create a file with 
the extension (space) AB, and no error message is given. 
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C . 2 UIC CAPACITY ON DISK DEVICES 


The maximum number of UIC's that a disk device directory can 
contain is dependent upon the block size of the device type. The 
maximum numbers are shown in Table C-l. 


Table C-l 

UIC Capacity of Disk Devices 

Disk Device Block Size Maximum Number 


Type 

(in words) 

of UIC's 

RC11 

64 

15 

RF11 

64 

15 

RK11 

256 

63 


(The maximum capacity is the integer result of subtracting one 
from the block size and dividing that by four.) 


C . 3 TRANSFER OF ASCII CARDS 


To transfer ASCII cards from the card reader to disk or DECtape, 
the /FA switch must be used. 

C. 4 ALLOCATE SWITCH 


The ALLOCATE switch (/AL: ) allows the user to create a blank 
contiguous file and specify its length. Data subsequently can be 
transferred from a nonfile-structured device to the blank contigu- 
ous file. Without the ALLOCATE switch, it would be impossible for 
the system to determine the size of the file from a nonfile-structured 
input device. Data can also be transferred from a file-structured 
device to a blank contiguous file. However, allocation of the file 
space is not necessary since the file-structured input device con- 
tains the necessary size information in its directory. (See the 
description of the CONTIGUOUS (/CO) switch.) 
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INDEX 


A error message, 1-2 
Abort current job, 1-3 
Action switches, 2-6, 2-7, 2-8 
/AL (Allocate) 

/BR (Brief Directory 
/DE (Delete) 

/DI (Directory) 

/EN (Enter) 

/FC (Fast Copy) 

/FR (Free Blocks) 

/PR (Protect) 

/RE (Rename) 

/RU (Run) 

/RW (Rewind and Unload) 

/UN (Unformatted) 

/VE (Verify) 

/ZE (Zero) 

Allocate, 1-1 

Angle bracket (<) , 2-3, 3-8 
ASCII mode, 3-4 

Asterisk, 2-3, 2-4, 3-4, 3-9, 4-4, 
4-6 

feature, 2-4, 2-6, 4-8, 5-1 
type command, 3-10 
type transfers, 3-11 


Batch stream, 1-3 

BEGIN command, 1-3 
Binary mode, 3-4 
Bit maps, 4-10 
Blank contiguous file, 3-13 
Block, 3-3, 4-2 
size, 3-13 
Brackets , 

angle, 2-3, 3-8 
square, 2-5 

/BR (brief directory) switch, 
2-3, 4-6, 5-1 
listing, 4-7, 4-8 


C, 3-13 

Carriage return, 3-10 
Cartridge, 4-10 

high-density, 4-11 
low-density, 4-11 
$ CHANGE command, 1-4 
Changing filenames, 3-2, 3-8 
/CO (Copy) switch, 3-5, 3-6 
operation, 3-5 
Code, switch, 2-5 
Colon, 2-5, 2-7 
Combine, 3-3 
Comma, 2-3, 2-5 
Command 

format, 2-1 


command (cont'd), 

LOGIN, 2-5 

string, 1-2, 2-2, 2-5, 3-6 
interpreter, 2-1 
Concatenating files, 4-10 
CONFIRM, 4-11 
Confirmation, 2-6 
Contiguous file, 2-6, 3-5, 3-6, 

3-13 

creation, 3-13 
CONTINUE command, 1-2 
CTRL/C command, 1-3, 3-7 
Control function, 1-1 
Controller, 2-2 
Copy, 1-1, 3-1, 3-3 
operation, 3-8 
CSI, 2-1 

Data format, 5-4 
Date, 4-3, 4-5 
Default I/O device, 2-3 
Delete, 1-1, 2-4 
all files, 3-10 
switch (/DE) , 3-9 
Device specification, 2-2 
default input, 2-3 
Directory, 1-1 

listing operations, 2-4, 4-7, 5-1 
.MAC extension unit 0 , 4-8 
/DI switch , 2-3, 4-5, 4-7, 5-1 
Dollar sign character, 1-2, 1-3 
Duplicate, 3-1 


Edit, 3-10 

function, 1-1 
END, 3-7 

END PT command, 3-7 
End-of-file, 3-7, 5-3 
/EN(ter) switch, 4-1 
Error, 1-2 

messages, 7-1, 7-2 
action switch 
allocate 
CONFIRM 
DECtape 

file record size 
file recovery 
EOD 

illegal command 
illegal file operation 
illegal switch 
input files 
MFD 

mode of transfer 
non-privileged user 
null filename 
output files 
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Error messages (coni;.), 7-1, 7-2 
protect code 
record size 

standard filename extension 
S264 

using fast copy 

using high-density RK03/05 (H) 

using low-density RK03 (L) 

using meaningless commands 

wildcard operation 

zero 

Exit from PIP, 1-3 

ext (filename extension) , 2-1 


F error message, 1-3 
Factor, interleave, 3-5 
Fast Copy (/FC) switch, 3-2 
Fatal condition, 1-3 
File, 2-1 

contiguous, 2-6, 3-5, 3-6 
creation date, 4-2 
designator, 3-9 
input, 2-1 
linked, 3-5, 3-6 
manipulation, 4-1 
output, 2-1 
protection, 2-5 
protection code, 3-12, 4-2 
DELETE 
READ 
RUN 
WRITE 

segment, 3-13 
specification, 2-2, 3-11 
transfer, 3-1, 3-5, 3-10 
Filename, 2-3 

extension, 2-4, 3-4 
specification , 2-3 
specification, 2-3 
File transfer operation, 5-1 
$ FINISH command, 1-2, 1-4 
Format, 5-3 

cassette tape, 6-2 
data, 5-4 
general, 5-4 
switch, 3-4 

/FA (Formatted ASCII) 

/FB (Formatted Binary) 

/UA (Unformatted ASCII) 

/UB (Unformatted Binary) 
Formatted ASCII mode, 2-6 
Formatted Binary mode, 2-6 
/F R switch, 2-3, 4-9 
Free blocks, 1-1, 2-6, 4-4, 4-9 
Full directory, 4-3 (/DI) 

listing, 3-13, 4-2, 4-4, 4-9 
Functions 

control, 1-1 
editing, 1-1 


$GET command, 1-4 


Helpful hints, B-l 
High-speed paper tape punch, 3-7 
High-density (H) , 4-11 
cartridges, 4-11 


Inaccessible state, 4-11 
Input 

file, 2-1, 3-1 
Inspect switch (/IN) , 3-10 
Interleave factor, 3-5 
Initialize, 4-9 

cassette tape, 6-2 
disk, 4-11 
RK11 disk, 4-10 

$ JOB command, 1-4 


KB transfer, 3-7 
KILL 

command, 1-1, 1-2, 1-3 
sequence, 1-4 
terminates PIP, 1-3 


L (low density) , 4-11 
LINE feed key, 3-7 
Linked file, 3-5, 3-6 
List, 2-6 
Listing, 1-1, 5-1 
full directory, 3-6 
LOCK bit, 4-11 

LOGIN command, 1-2, 2-5, 4-1 
Low-density cartridges, 4-11 
Low-speed paper tape reader, 3-7 


Magnetic (Magtape) tape, 2-6, 5-1, 
5-3 

initialization, 5-1 
Master File Directory (MFD), 2-6, 
4-1, 4-10 

Merge, 1-1, 3-1, 3-3 
operation, 3-5 
single file, 3-3 
Mode 

ASCII, 3-4 
Binary, 3-4 
formatted ASCII, 2-6 
formatted Binary, 2-6 
transfer, 3-4, 3-5 
Multiple devices, 4-3 
Multiple units, 2-2 


Non-transfer operations , 2-5 
Null 

extension, 2-4 
fields, 2-3 
Number of blocks, 4-5 

Number sign character, 1-2, 3-7, 4-11 
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Operation , 
copy, 3-5 
deletion, 2-4 
directory listing, 2-4 
merge, 3-5 
non- transfer , 2-5 
protection, 2-4 
rename, 2-4 
transfer, 2-4 
Options, switch, 2-6 
Output file, 2-1 
designation, 3-1 


Paper tape reader, 3-5 
Partial list, 4-4 
Peripheral, 3-1 
Period, 2-3 

PIP (Peripheral Interchange 
Program), 1-1, 1-2 
Programming cautions, C-l 
Project listing, user no. 200, 4-8 
Protect switch (/PR), 3-11 
Protection, 1-1, 2-6 
change, 3-11 
code, 3-11 
file, 2-5 
operation, 2-4 


Qualifying switches, 2-6, 2-7, 2-8 
'/CO (Copy) 

/FA (Formatted ASCII) 

/FB (Formatted Binary) 

/IN (Inspect) 

/SU (Supersede) 

/UA (Unformatted ASCII) 

/UB (Unformatted Binary) 


Random accessing, 3-5 
Recovery, 4-11 
Rename, 1-1, 2-4 
operation, 2-4 
switch (/RE), 3-2, 3-8 
Replace, 1-1, 2-6, 3-10 
RESTART command, 1-3 
RETURN key, 1-2 

Rewind switch, 5-1, 5-2, 6-1, 6-2 

Rewind and Unload switch, 5-1, 5-3 

RKll disk, 4-10 

$RUN command, 1-2, 1-4 

RUN PIP command, 1-2 


S error message, 1-3 
Sequence of filenames, 3-9 
SHIFT/K, 2-5 
SHIFT/M, 2-5 
Slash, 2-5 
Specification , 
device, 2-2 

filename extension, 2-3 


Specification (cont. ) 
switch, 2-2 

UIC (user identification code) , 

2-5 

Square brackets, 2-5 

Standard filename extension, 3-4 

String, command, 2-5 

Storage, file, 2-5 

Summaries, A-l 

Supersede 

SU:OFF command, 3-11 
SU : ON command, 3-11 
mode, 3-11 

switch, (/SU) , 3-10, 3-11 
Switch , 

/AL (Allocate), 2-6, 3-13 
/BR (Brief Directory), 2-6, 4-7 
/CO (Contiguous) , 2-6 
/DE (Delete), 2-6, 3-10 
/DI (Directory), 2-6, 3-10 
/EN (Enter) , 2-6 
/FA (Formatted ASCII) , 2-6, 3-5 
/FB (Formatted Binary), 2-6, 3-5 
/FC (Fast Copy) , 2-6 
/FR (Free) , 2-3, 2-6 
/IN (Inspect) , 2-3 
/PR (Protect) , 2-6 
/RE (Rename), 2-6, 3-10 
/RU (Rewind and Unload) , 2-6 
/RW (Rewind) , 2-6 
/SU (Supersede) , 2-6 
/UA (Unformatted ASCII) , 2-7, 3-5 
/UB (Unformatted Binary), 2-7, 3-5 
/UN (Unlock) , 2-7 
/VE (Verify) , 2-7 
/VW (Verified Write) , 2-7 
/ZE (Zero), initialize , 2-7 
Switch code, 2-2, 2-5 
Switch name, 2-5 
Switch options, 2-6 
Switch specification, 2-2, 2-5 
System, crash, 4-11 
program error, 6-1 

Transfer, 1-1 
command, 3-10 
file, 3-1 

operation, 2-4, 3-6, 6-1 
teleprinter, 3-7 


UIC (user identification code) , 
2-1, 2-4, 2-6, 3-3, 3-9, 4-1, 
4-2, 4-5, 4-10, 5-1 
field, asterisk in, 4-8 
specification, 2-5 
/UN switch (Unlock) , 4-11 

Unformatted ASCII, 3-4 
Unformatted Binary, 3-4 
Units, 2-2 
Used blocks, 4-4 
User Free Directory (UFD) , 4-1 

entry, 4-11 

usage count in entry, 4-11 
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User group, 2-5 


Verify (/VE) , switch, 1-1, 3-2, 3-3 
Version number, 1-2 


Word, 3-3 


Y (Yes) reply, 3-10 


Zero (Initialize) switch, 

1-1, 3-10, 4-2, 4-9, 4-10, 5-2 
DECtape, 4-10 
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HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software , as well as programming 
notes , software problems , and documentation corrections, are published 
by Software Information Service in the following newsletters. 

DIGITAL Software News for the PDP-8 and PDP-12 
DIGITAL Software News for the PDP-11 
DIGITAL Software News for 18-bit Computers 

These newsletters contain information applicable to software available 
from DIGITAL'S Software Distribution Center. Articles in DIGITAL 
Software News update the cumulative Software Performance Summary which 
is included in each basic kit of system software for new computers. 
To assure that the monthly DIGITAL Software News is sent to the 
appropriate software contact at your installation, please check with 
the Software Specialist or Sales Engineer at your nearest DIGITAL 
office. 

Questions or problems concerning DIGITAL'S software should be reported 
to the Software Specialist. If no Software Specialist is available, 
please send a Software Performance Report form with details of the 
problems to: 

Digital Equipment Corporation 
Software Information Service 
Software Engineering and Services 
Maynard, Massachusetts 01754 

These forms, which are provided in the software kit, should be fully 
completed and accompanied by terminal output as well as listings or 
tapes of the user program to facilitate a complete investigation. An 
answer will be sent to the individual, and appropriate topics of 
general interest will be printed in the newsletter. 

Orders for new and revised software manuals, additional Software 
Performance Report forms, and software price lists should be directed 
to the nearest DIGITAL field office or representative. USA customers 
may order directly from the Software Distribution Center in Maynard. 
When ordering, include the code number and a brief description of the 
software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user 
library and publishes a catalog of programs as well as the DECUSCOPE 
magazine for its members and non-members who request it. For further 
information, please write to: 

Digital Equipment Corporation 
DECUS 

Software Engineering and Services 
Maynard, Massachusetts 01754 




DOS/BATCH File Util 
Program (PIP) 
DEC-ll-UPPAA-A-D 


READER'S COMMENTS 


NOTE: This form is for document comments only. Problems 

with software should be reported on a Software 
Problem Report (SPR) form (see the HOW TO OBTAIN 
SOFTWARE INFORMATION page) . 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent 

□ Assembly language programmer 

□ Higher-level language programmer 

□ Occasional programmer (experienced) 

PI User with little programming experience 
| | Student programmer 

□ Non-programmer interested in computer concepts and capability 

Name Date 

Organization 

Street 

City State Zip Code 

or 

Country 

If you do not require a written reply, please check here. □ 
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Digital Equipment Corporation 
Software Information Service 
Software Engineering and Services 
Maynard, Massachusetts 01754 





